FILES: File Listing Program, Version 2.10
       (C)Copyright, James H. Coombs, 1986


Use the FILES command to list all files on a device that match  a specified  id.
FILES  is  similar  to  other file-locating utilities but is considerably faster
than other versions,  enables  one  to  specify a pseudo-root directory, enables
searching for multiple files in the same  invocation,  and uses the same display
format as KEDIT's DIR command.

The syntax of the FILES command is:

+----------+-------------------------------------------------------------------+
|          |                                                                   |
| FILES    | [d:][pseudo-root][filespec [filespec [...]]]                      |
|          |                                                                   |
|          | Examples:  FILES                                                  |
|          |            FILES listit                                           |
|          |            FILES \progs\*.c *.h                                   |
|          |                                                                   |
+----------+-------------------------------------------------------------------+


Operands:

d:        is the drive to search.   If not specified, FILES searches the current
          drive.  'FILES C:*.SCR' would search drive  'C' for all files with the
          extension 'SCR'.

pseudo-root is the directory to be taken  as the root directory of the drive for
          the current search.  If  not specified, FILES begins its search at the
          actual root of the drive.  'FILES C:\PROGS\C\*.EXE' would search drive
          'C' for  all  'EXE'  files  in  directory  '\PROGS\C'   and   in   all
          subdirectories of '\PROGS\C'.   Note  that  pseudo-roots should always
          end in the path separator  '\':  'FILES  \bozo' begins a search at the
          root directory for  'bozo.*';  'FILES  \bozo\'  begins a search in the
          directory '\bozo' for '*.*'.

filespec  is  the  fileid  to  search  for.   This may be  any  valid  DOS  file
          specification.  'FILES PROFILE.SCR' would search the current drive for
          all occurrences  of 'PROFILE.SCR'.  If no filespec is specified, FILES
          lists  all files.  Version 2.00 accepts  multiple  specifications,  so
          'FILES *.C *.H' would list all C source files and header files.


Options:

There are no options in this version of FILES.


Usage Notes:

1.  Redirection of output:
    FILES  writes  to  standard  output,  which  may be redirected to a file,  a
    printer, or any other valid device.   Since the output is in the same format
    as KEDIT's  DIR  command,  KEDIT  users  will be able to use their  standard
    macros on FILES' output.

2.  Speed of operation:
    FILES  runs about twice as fast as some commercial utilities and  marginally
    faster  than  the assembler version of the popular WHEREIS.  Searches  on  a
    well-organized  drive  can  be  made  even faster by taking advantage of the
    pseudo-root feature.

3.  Pseudo-roots:
    Under DOS 2.xx and later,  every  disk  has  a root directory.  In addition,
    well-organized  disks  have  a number of subdirectories, sub-subdirectories,
    etc.   By  default, a file search begins at the root directory, but searches
    may be speeded by specifying a pseudo-root.  If, for example, one stores all
    source code under the directory '\PROGS', the search for source files should
    begin at '\PROGS' instead of at the actual root, '\'.

4.  Files included:
    FILES includes all files in  its  search  except for system files and volume
    labels.


Responses:

d: fname    ext     bytes      date   time  directory
c: allfiles.bat        85   1-30-86  23:21   \cmd


Version history:

1.00 - 02/12/86 - Initial release.

2.00 - 03/14/86 - Minor debugging and tuning.  New features:

       Allow specification of multiple file patterns.
       Direct copyright notice to stderr instead of stdout.
       Display blank lines between directories when output has not been
          redirected.
       Pause at each screenful when output has not been redirected.

2.10 - 03/24/86 - Include hidden directories and directories with extensions.
reenful when output has not been redirected.

2.10 - 03/24/86 - Include hidden directories and directories wit